home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / db / esm-3.1 / esm-3 / usr / local / sm / doc / sm3docdiff.me < prev    next >
Encoding:
Text File  |  1996-05-05  |  6.7 KB  |  227 lines
  1. .\" use larger type so that it looks OK after photo-reducing
  2. .nr pp 12\" use larger point size
  3. .nr sp 12\" yep, I really mean it
  4. .nr tp 12\" and I'll mean it after other stuff
  5. .nr fp 10\" don't reset to 10 point (and use 9 footnotes)
  6. .sz 12\" believe me!!!
  7. .\"
  8. .\" USING THE EXODUS STORAGE MANAGER -- 2.2.2, 3.0 delta 
  9. .\"
  10. .po 1.0i
  11. .ll 6.5i
  12. .ls 1
  13. .ce 4
  14. .sz 14
  15. \fBUsing the EXODUS Storage Manager V3.0\fR
  16. .sz 12
  17. Differences between V2 and V3.0.
  18. Last revision: May, 1993
  19. .sp 3
  20. .fo ''%''
  21. .br
  22. .sh 1 "Introduction"
  23. .pp
  24. This document summarizes the differences between
  25. versions 2 and 3.0 of the Exodus Storage Manager.
  26. \*(lqV2\*(rq refers to all Version 2 releases:
  27. V2.0, V2.1, and V2.2).
  28. This document includes references to the sections of the V3.0 user
  29. guide,
  30. \fBUsing the EXODUS Storage Manager V3.0\fR.
  31. The section numbers do not correspond to the V2 documents.
  32. The reader is assumed to be familiar with a V2 release.
  33. .br
  34. .sh 1 "Release"
  35. .np
  36. V3.0 runs on HP 7xx platforms running under HP-UX.
  37. .np
  38. The makefiles have been changed so that the sources are combined before
  39. making; 
  40. V3.0 compiles in substantially less time than V2,
  41. and it uses less disk space for object files.
  42. .np
  43. V3.0 is made with g++ (V2 was made with ATT C++).
  44. .sh 1 "General Functionality"
  45. .np
  46. Includes bulk-loading of linear hashed indexes.
  47. (Section 4.10.3)
  48. .np
  49. Includes two forms of distributed transactions.
  50. \*(lqInternally distributed\*(rq transactions
  51. are transactions that span several Storage Manager servers.
  52. The application - client library interface supports these
  53. with no changes from V2.
  54. An \*(lqexternally distributed\*(rq transaction
  55. is a 
  56. Storage Manager transaction (possibly using several servers)
  57. that is a \*(lqthread\*(rq of a \*(lqglobal transaction\*(rq
  58. that may involve other transaction processing systems. 
  59. The application - client library interface supports these transactions
  60. with a set of new functions.
  61. (Sections 4.3, 4.11)
  62. .np
  63. The application no longer uses
  64. file names for volumes.
  65. Volumes are known by their volume IDs.
  66. Only servers know how to map a volume ID to a Unix path name.
  67. (Sections 4.4, 5.1.)
  68. .np
  69. Volumes are \*(lqauto-mounted\*(rq:
  70. applications 
  71. no longer explicitly open and close
  72. connections to servers.
  73. References to data cause the proper servers to be contacted.
  74. (Sections 4.4, 5.1.)
  75. .np
  76. The servers and client library keep expanded statistics about
  77. their message traffic. 
  78. (Section 4.11.2)
  79. .sh 1 "Application - Client Library Interface"
  80. .sh 2 "Reporting Errors "
  81. .np
  82. The client library exports a new global variable,
  83. \fCsm_reason\fR.
  84. When a transaction is aborted by the Storage Manager,
  85. \fCsm_reason\fR indicates why the transaction was aborted.
  86. (Section 4.1)
  87. .np
  88. V3.0 is a little smarter about reporting that a transaction
  89. was aborted.
  90. In some cases when V2 reported an 
  91. \*(lqunknown transaction identifier\*(rq
  92. error because it lost track of the transaction
  93. that was aborted,
  94. V3.0 reports 
  95. \*(lqtransaction aborted\*(rq.
  96. (Section 4.1)
  97. .sh 2 "New Functions"
  98. .np
  99. New administrative functions allow a client to determine
  100. the type of a volume and print the expanded message statistics.
  101. (Section 4.11.2)
  102. .np
  103. New administrative functions allow 
  104. a client to change the server's table of mountable 
  105. volumes (a table that did not exist in V2).
  106. (Section 4.11.2)
  107. .np
  108. sm_RemoveRootEntry( ) allows root entries to be removed.
  109. (Section 4.5.)
  110. .sh 2 "Changed Functions"
  111. .np
  112. The function sm_Initialize( ) no longer takes any parameters.
  113. (Section 4.2)
  114. .np
  115. All the administrative functions have new arguments
  116. to determine which server(s) are of interest.
  117. (Section 4.11.2)
  118. .np
  119. The arguments to the function sm_MountVolume( ) 
  120. have new meanings,
  121. although the function's prototype is unchanged
  122. for the sake of backward compatibility.
  123. (Section 4.4)
  124. .np
  125. The sm_* functions (Sections 4.7.1, 4.7.3)
  126. that create objects or change the sizes
  127. of objects break their operations down into chunks of a 
  128. .q "reasonable" 
  129. size when the operation involves a large amount of data.  
  130. These functions 
  131. take into account the size of the buffer
  132. group when chosing a reasonable size.
  133. As a result, operations are less likely to 
  134. fail for lack of buffer space.
  135. .sh 2 "Client Options"
  136. .np
  137. The
  138. \fCmount: volid port@server\fR 
  139. option tells where to find the server that manages the volume.
  140. (Section 4.2, 4.4.)
  141. .np
  142. The
  143. \fCpagelock: SH or EX\fR
  144. option determines the default lock mode for pages.
  145. It replaces a global variable.
  146. (Section 4.2, A.1)
  147. .np
  148. The
  149. \fClocktimeout: # 10-second intervals\fR
  150. optin limits the amount of time the application will 
  151. await a lock before the lock request fails with esmLOCKBUSY.
  152. (Section 4.2, A.3.)
  153. .sh 1 "Server"
  154. .sh 2 "Server Options"
  155. .lp
  156. (All the server options are described in Section 5.2.2.)
  157. .np
  158. The \fCwrapcount\fR option
  159. is seldom, if ever needed.
  160. the server figures out what wrap count it needs to use
  161. for the volumes listed in the server's configuration files.
  162. (If volumes are added later, the server might have to be restarted
  163. with a higher wrap count.)
  164. .np
  165. The
  166. \fCbackground\fR option is no longer needed for users
  167. of csh(1) and other shells that have job control;
  168. the server figures out if it is in the background.
  169. (Bourne shell users still need this option.)
  170. .np
  171. The
  172. \fCmaxvolumes\fR option is no longer available;  
  173. the server figures out what to use by reading the configuration file.
  174. .np
  175. The 
  176. \fCextrastats\fR option
  177. is no longer available; the stats are no longer printed.
  178. .np
  179. The
  180. \fCpreflushlog\fR option is no longer available; it is always on.
  181. .np
  182. The
  183. \fClogformat, tempformat, dataformat\fR 
  184. and
  185. \fCmaxaddvolumes\fR
  186. options are new configuration-file options; 
  187. they tell the server what volumes to manage.
  188. (Section 5.1, 5.2.2)
  189. .sh 2 "Server Commands"
  190. .lp
  191. The server's terminal interface has been expanded to include these
  192. commands (described in section 5.2.3):
  193. .np
  194. \fClistdistr\fR prints two lists two sets of distributed
  195. transactions: the transactions for which this 
  196. server is the coordinator,
  197. and the prepared transactions for which it is a subordinate server.
  198. .np
  199. \fCprogress\fR toggles the \fCprogress\fR option's value.
  200. .np
  201. \fCuser\fR determines
  202. whether the server will print messages when a user (application) error
  203. is encountered.
  204. .np
  205. \fCsource\fR reads a set of commands from a file.
  206. .np
  207. \fCredirect\fR redirects output to a file.
  208. .np
  209. \fClistmount\fR lists the volumes that are in use.
  210. .np
  211. \fClistvolumes\fR lists the volumes in the mountable-volume table.
  212. .np
  213. \fCaddvolume\fR adds a volume to the mountable-volume table.
  214. .np
  215. \fCrmvolume\fR removes a volume from the mountable-volume table.
  216. .sh 1 "Formatting Volumes"
  217. .lp
  218. Formatting volumes is done differently.
  219. The information regarding the format of a volume
  220. is now given to the formatter through configuration
  221. options, found in a configuration file.
  222. (Section 5.1.5)
  223. .sh 1 "Bugs Fixed"
  224. .lp
  225. All known bugs from V2 have been fixed.
  226. Numerous efficiency improvements have made.
  227.